home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / list70a.arc / LIST.DOC < prev    next >
Text File  |  1989-10-18  |  93KB  |  2,830 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                       LIST
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                       A File Viewing and Browsing Utility
  21.  
  22.                    Version 7.0                  October 1989
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.           (c) Copyright  Vernon D. Buerg 1983-89.  All rights reserved
  44.             T A B L E   O F   C O N T E N T S
  45.  
  46. __________________________________________________________________________
  47.  
  48.  
  49.  Getting Started  ...................................................... 1
  50.      Introduction  ..................................................... 1
  51.      Installation  ..................................................... 1
  52.      Printing the manual  .............................................. 1
  53.      Varieties of LIST.COM  ............................................ 2
  54.  
  55.  Definition of DOS terms  .............................................. 3
  56.      DOS Redirection  .................................................. 3
  57.      DOS Filters  ...................................................... 3
  58.      DOS Pipes  ........................................................ 4
  59.  
  60.  Command line  ......................................................... 5
  61.      Command line syntax  .............................................. 5
  62.      Command line switches  ............................................ 5
  63.  
  64.  How to use LIST  ...................................................... 6
  65.      Starting LIST  .................................................... 6
  66.      Exiting LIST  ..................................................... 7
  67.        Entering Commands  .............................................. 7
  68.      Display Format  ................................................... 8
  69.        Status Line Format  ............................................. 8
  70.        Command Line Format  ............................................ 9
  71.      Scrolling  ........................................................ 11
  72.      Positioning to Lines  ............................................. 12
  73.      Filtering  ........................................................ 13
  74.        Wrap Filter  .................................................... 13
  75.        Hi-bit Filter  .................................................. 14
  76.        Star Filter  .................................................... 14
  77.        Junk Filter  .................................................... 14
  78.        Hex Format Filter  .............................................. 14
  79.      Scanning for text  ................................................ 15
  80.        Summary of scanning commands:  .................................. 16
  81.      Marking and Extracting Lines  ..................................... 17
  82.      Printing  ......................................................... 18
  83.      Displaying multiple files  ........................................ 19
  84.      Windows  .......................................................... 20
  85.      Telephone dialer  ................................................. 20
  86.  
  87.  DOS considerations  ................................................... 21
  88.      File Sharing  ..................................................... 21
  89.      Invoking DOS Commands  ............................................ 21
  90.      Screen Saving  .................................................... 21
  91.  
  92.  File Selection Menu  .................................................. 22
  93.      LIST PLUS Display  ................................................ 22
  94.      Movement Keys  .................................................... 22
  95.      Changing Directories  ............................................. 23
  96.      List file  ........................................................ 23
  97.      Copy file  ........................................................ 23
  98.      Delete file  ...................................................... 23
  99.      Move file  ........................................................ 23
  100.      Path changing  .................................................... 23
  101.      Rename  ........................................................... 24
  102.      Sort filenames  ................................................... 24
  103.      1-6 up display  ................................................... 24
  104.      ViewArc  .......................................................... 24
  105.  
  106. Contents 1                                             LIST  User's Guide
  107.             T A B L E   O F   C O N T E N T S
  108.  
  109. __________________________________________________________________________
  110.  
  111.  Command key summary  .................................................. 25
  112.      Cursor keys  ...................................................... 25
  113.      F- function keys  ................................................. 25
  114.      Letter keys  ...................................................... 26
  115.      Control- keys  .................................................... 28
  116.      Alt- keys  ........................................................ 29
  117.  
  118.  Configuring LIST  ..................................................... 30
  119.      Screen Colors  .................................................... 30
  120.      Cloning  .......................................................... 31
  121.      Modifying LIST.COM  ............................................... 32
  122.        Locations of option values  ..................................... 32
  123.        Reassigning keys  ............................................... 34
  124.        Table of Routines  .............................................. 35
  125.  
  126.  Limitations  .......................................................... 38
  127.  
  128.  Copyright/License/Warranty  ........................................... 39
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. LIST  User's Guide                                            Contents 2
  171. Getting Started
  172. ______________________________________________________________________________
  173.  
  174. Introduction
  175.  
  176.  
  177.     You use LIST to display files on your monitor, line by line with the
  178.     aid of scrolling, positioning and filtering commands.
  179.  
  180.     LIST PLUS has many new  commands which go beyond usual  file viewing
  181.     and browsing.  We will  explain how LIST is  used, and then how  the
  182.     new file management commands are used.
  183.  
  184.     Before going  into all  of the  ways in  which LIST  can be  used to
  185.     display files, let's look at  the three different varieties of  LIST
  186.     so that you understand the capabilities of each.  Then, we'll go  on
  187.     and define certain terms  like: redirection, piping, and  filtering.
  188.     In this way, you will better understand how you can use these things
  189.     with LIST.
  190.  
  191.  
  192. Installation
  193.  
  194.     There are three varieties of the  LIST program on the disk that  you
  195.     received (or in the file  that you downloaded).  This allows  you to
  196.     pick the version of LIST that is right for you, and to configure  it
  197.     to be exactly the way YOU want it to be.
  198.  
  199.     Decide which of the LIST programs you would like to use and copy the
  200.     .COM file to your working disk, or into a subdirectory on your  hard
  201.     disk.  Selecting a directory that is in your PATH will allow you  to
  202.     use LIST from anywhere on your system.
  203.  
  204.     You may  rename the  program file  to any  convenient name,  such as
  205.     L.COM,  READ.COM,  LST.COM  or  leave  it as LIST.COM.  For example,
  206.     place the distribution disk into drive A and enter the commands:
  207.  
  208.             A:
  209.             COPY LISTP.COM C:\L.COM
  210.  
  211.     to copy  the Plus  version to  the root  directory of  your C drive,
  212.     renaming the program to L.COM in the process.
  213.  
  214. Printing the manual
  215.  
  216.     To print the documentation, set your printer for six lines per inch,
  217.     and 10 characters per inch.   Then, use the DOS PRINT  command.  For
  218.     example,
  219.  
  220.                         PRINT LIST.DOC
  221.  
  222.     You may also  print out the  documentation by using  redirection and
  223.     entering:
  224.  
  225.                         TYPE LIST.DOC > LPT1
  226.  
  227.     Better yet, use LIST to print the manual.  Enter
  228.  
  229.                         LIST LIST.DOC
  230.  
  231.     then press the Ctrl and P keys at the same time.
  232.  
  233.  
  234.  
  235. Page  1                                                    LIST  User's Guide
  236. Getting Started
  237. ______________________________________________________________________________
  238.  
  239. Varieties of LIST.COM
  240.  
  241.  
  242.  
  243.         - LISTS.COM     small version
  244.  
  245.           - runs in about 30k
  246.           - limited to smaller files (around 600kb),
  247.           - excludes the Alt-X (screen saving) function
  248.           - excludes the Alt-G (goto DOS) function
  249.           - the Help screen is minimal.
  250.  
  251.  
  252.  
  253.         - LIST.COM      regular version
  254.  
  255.           - runs in about 80K
  256.           - handles files up to 16 mb
  257.           - excludes the Alt-V (file selection) function
  258.           - excludes the Alt-I (insert filename) function
  259.           - the Alt-W (windowing function) is minimal, i.e. you get two
  260.             equal sized windows; there is no ability to change window
  261.             dimensions
  262.  
  263.  
  264.  
  265.         - LISTP         PLUS version
  266.  
  267.           - plus Alt-V file selection menu
  268.           - plus file management functions like copy and delete
  269.           - plus Alt-I hypertext-like file selection
  270.           - plus a secondary help screen for the "special" functions
  271.           - plus the Ctrl-T telephone dialer
  272.  
  273.  
  274.  
  275.     The documentation file is marked  with | before new and  changed
  276.     lines.  It is marked  with a double asterisk  ** for LIST PLUS
  277.     only features.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286. WARNING:  LIST PLUS (LISTP.COM), HAS THE ABILITY TO *DELETE*
  287.           FILES FROM YOUR SYSTEM!!
  288.  
  289.  
  290. IF YOU ELECT TO USE LIST PLUS, PLEASE READ THE SECTION ON THE FILE
  291. SELECTION MENU FOUND LATER ON IN THIS MANUAL.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300. LIST  User's Guide                                                    Page  2
  301. Definition of DOS terms
  302. ______________________________________________________________________________
  303.  
  304.  
  305.  
  306. DOS Redirection
  307.  
  308.     The output of a  DOS command can be  "redirected" to a device  other
  309.     than  the  standard  output  device,  which  is  in  most cases, the
  310.     monitor.  This is done simply by entering the command, followed by a
  311.     ">" and then the name of the desired device.  For example.
  312.  
  313.     If you type "DIR > FILE.LST" you will see nothing on your screen and
  314.     then suddenly your  DOS prompt will  reappear.  What happened?   The
  315.     "output" of the DIR command was "redirected" to the file, FILE.LST.
  316.  
  317.     In the same manner, you  could enter the following command  and send
  318.     the contents of FILE.LST to your printer, like so: "TYPE FILE.LST  >
  319.     LPT1"
  320.  
  321.     The ">" symbol stands for  redirection of output to another  device.
  322.     Broken down simply, the following command is saying:
  323.  
  324.                     DIR            >       FILE.LST
  325.           (send output of this)  (TO)   (This device, which is a file)
  326.  
  327.     By the same token, you can also redirect "input" to a DOS command or
  328.     a program like SORT  by using the "<"  symbol.  Here is an  example:
  329.     "SORT  <  FILE.LST"  This  command  would  take  the  information in
  330.     FILE.LST  and  "redirect"  it  into  SORT.   For more information on
  331.     redirection, you  may want  to consult  a DOS  manual or  other such
  332.     reference.
  333.  
  334.  
  335. DOS Filters
  336.  
  337.     FILTERS are  commands, or  programs, that  read data  from an  input
  338.     device, and  then rearranges  or "filters"  the data  before it then
  339.     outputs the  filtered information  to an  output device.   DOS comes
  340.     with several "filters", one of which is SORT.  The following command
  341.     would sort the file in alphabetical order.
  342.  
  343.                                 SORT < FILE.LST
  344.  
  345.     You are redirecting the file,  FILE.LST through the SORT filter  and
  346.     it is rearranging the file.  Taking what you know about  redirection
  347.     and  filters,  you  could  now  send  your  alphabetical list to yet
  348.     another  file  by  entering:  SORT  <  FILE.LIST  > ALPHA.LST, which
  349.     redirects FILE.LST into the SORT "filter" and then redirects the new
  350.     output  to  the  file  ALPHA.LST.   LIST  also has some very helpful
  351.     "filters" built  right into  it and  we'll discuss  these later  on.
  352.     Simply keep in mind that when  you use a "filter" it will  rearrange
  353.     or alter the  information into a  form that is  more presentable, or
  354.     useful, to you.
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Page  3                                                    LIST  User's Guide
  366. Definition of DOS terms
  367. ______________________________________________________________________________
  368.  
  369.  
  370. DOS Pipes
  371.  
  372.     Pipes are  quite similar,  in some  ways, to  redirection.  They are
  373.     "connections" between two programs or two commands or a command  and
  374.     a program.   Pipes take  data that  is output  from one  program and
  375.     redirect it as input to a second program.  The DOS symbol for a pipe
  376.     is the vertical bar "|".  To redirect the output from one program or
  377.     command to another, you simply type the first command followed by  a
  378.     vertical bar and  then followed by  the second command.   Here is an
  379.     example of piping.
  380.  
  381.                                 DIR | FIND "-88"
  382.  
  383.     This command tells DOS to send the output of the DIR command,  which
  384.     you would normally see on the  screen, and send it through the  FIND
  385.     filter.  FIND  would be  searching each  line for  the string "-88".
  386.     Only the files in the current directory that have a 1988 date  stamp
  387.     would be displayed on the screen!  You can use more than one  "pipe"
  388.     in a command.  Take this final example:
  389.  
  390.                        DIR | FIND "-88" | SORT/+14 > PRN
  391.  
  392.     A "pipe" takes the  output of the DIR  command and converts it  into
  393.     input for the FIND  filter.  Then, a second  "pipe" is used to  send
  394.     the output from FIND as input  to the SORT filter.  As a  last step,
  395.     output from  SORT is  redirected to  the printer!   What would  this
  396.     command do??   It would  take the  DIR of  the current directory and
  397.     pipe it through the FIND filter, looking for files created in  1988.
  398.     Then the next pipe would SORT that information, sorting the files by
  399.     SIZE (the 14th column of each line) and then send the output to  the
  400.     printer.  For  more information  on PIPES,  consult a  DOS manual or
  401.     other reference.
  402.  
  403.     Now that you have  a basic understanding of  redirection, filtering,
  404.     and piping, we will go on to discuss the command line of LIST.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430. LIST  User's Guide                                                    Page  4
  431. Command line
  432. ______________________________________________________________________________
  433.  
  434.  
  435.  
  436. Command line syntax
  437.  
  438.     The command line format is:
  439.  
  440.  
  441.         LIST [filespec...filespec] [/switches]
  442.  
  443.  
  444.     You may supply  one or more  file specifications (filespecs).   LIST
  445.     will display  each file  which has  a filename  matching one  of the
  446.     filespecs.  If you  do not supply  one, LIST will  prompt you for  a
  447.     filespec, or present you with a file selection menu.
  448.  
  449.  
  450.  
  451. Command line switches
  452.  
  453.                 /S       indicates viewing a piped or redirected file
  454.  
  455.                 /J       sets Junk filter on
  456.                 /7       sets 7-bit display
  457.                 /8       sets 8-bit display
  458.                 /*       sets star filter on
  459.  
  460.                 /W       sets Wrap on
  461.                 /H       sets Hex dump mode
  462.                 /L       sets pre-Loading on
  463.                 /M       allows use of a mouse for moving the cursor
  464.  
  465.                 /Ftext   tells LIST to Scan for 'text' immediately
  466.  
  467.     The command line switch character is normally a slash, "/", but LIST
  468.     will use whatever  character that is  defined to DOS  as the command
  469.     line switch character, e.g. a  dash, "-".  Depending on your  needs,
  470.     you could load LIST using  any of these command line  switches, such
  471.     as:
  472.  
  473.                LIST MYFILE.TXT /W   which would set Word Wrap ON.
  474.  
  475.                LIST MYFILE.TXT /J   which turns on the JUNK filter
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495. Page  5                                                    LIST  User's Guide
  496. How to use LIST
  497. ______________________________________________________________________________
  498.  
  499. Starting LIST
  500.  
  501.  
  502.     To  start  LIST,  you  type  the  command  LIST,  at the DOS prompt,
  503.     followed by  the name(s)  of the  files that  you want  to see.  For
  504.     example:
  505.  
  506.  
  507.           C:>LIST CONFIG.SYS        (displays file CONFIG.SYS)
  508.  
  509.           C:>LIST *.DOC    (displays all DOC files in current directory)
  510.  
  511.  
  512.     The "filename" is optional.  If  omitted, LIST PLUS will bring  up a
  513.     display of ALL  files and subdirectories  in the current  directory.
  514.     You may use  the cursor keys  to highlight the  file that you  would
  515.     like to work  on and press  ENTER.  Or, you  may highlight any  sub-
  516.     directory entry and and press ENTER to change to that subdirectory.
  517.  
  518.  
  519.     You  may  also  use  LIST  to  display piped or redirected files.  A
  520.     discussion of redirection, piping, and filtering is at the beginning
  521.     of this manual.
  522.  
  523.     To display a redirected file, use a < (less than symbol) before  the
  524.     name of the file that was redirected and add the /S parameter to the
  525.     LIST command.
  526.  
  527.     For example, the output of the DIR command can be written to a  file
  528.     called XYZ, and then LIST can be instructed to read that file.
  529.  
  530.                 dir a: >xyz
  531.                 list <xyz /s
  532.  
  533.     To see a piped file, omit the filename, but supply the /S.
  534.  
  535.                 dir a: | list /s
  536.  
  537.     Or, to LIST a file within an ARC archive:
  538.  
  539.                 ARC /p arcname.arc filename.ext | list /s
  540.                                 - or -
  541.                 ARCE arcname filename.ext /p | list /S
  542.  
  543.     Here,  the  ARC   or  ARCE  program   is  invoked  to   extract  the
  544.     'filename.ext' file.   The /P  switch for  these programs  sends the
  545.     output to the  standard output device,  and this output  is piped to
  546.     LIST.
  547.  
  548.     Once the file is  displayed on your screen,  you may use the  cursor
  549.     positioning keys to move around and see different parts of the file.
  550.     There are also commands to search for text, print, split the screen,
  551.     display  other  files,  change  colors,  change  the way the data is
  552.     displayed, and many other operations.
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560. LIST  User's Guide                                                    Page  6
  561. How to use LIST
  562. ______________________________________________________________________________
  563.  
  564. Exiting LIST
  565.  
  566.  
  567.     There are several ways  to exit LIST depending  on how you want  the
  568.     screen to look.
  569.  
  570.     The F10 command returns you to DOS with the DOS prompt on the bottom
  571.     line.  The  last page  that was  displayed by  LIST is  left on  the
  572.     screen.
  573.  
  574.     The ESCape key also returns you to DOS without changing the  screen.
  575.     In LIST PLUS, the ESCape key is also used to cancel an operation, or
  576.     to exit file selection menu.
  577.  
  578.     The X command  returns you to  DOS and clears  the screen.  The  DOS
  579.     prompt is on the top line of the screen.
  580.  
  581.     The Alt-X command uses the screen saving feature.  It returns you to
  582.     DOS and displays the screen that you had before LIST was run.
  583.  
  584.  
  585.   Entering Commands
  586.  
  587.     You enter  commands by  pressing a  single key,  or a combination of
  588.     keys.  There  are often  several ways  to perform  the same function
  589.     with different keys.  For example, D and PgDn both perform a  scroll
  590.     down one page function.   This lets you pick  the keys that you  are
  591.     most accustomed to.
  592.  
  593.     When  you  press  keys,  they  are  entered  into a keyboard buffer.
  594.     Holding down a key can put many copies of that key into the  buffer.
  595.     This means that when you let up  on a key, the program can still  be
  596.     processing input from the keyboard buffer.  For example, by  holding
  597.     down the PgDn key, LIST scrolls down one page for each time the PgDn
  598.     key is placed in the keyboard  buffer.  When you let up on  the key,
  599.     the buffer may not yet be empty and LIST will continue to page down.
  600.     To make  LIST stop  when you  let up  on a  key, you  use the  Alt-K
  601.     key-ahead toggle.
  602.  
  603.     Keyboard enhancement utilities,  such as PCED,  may also change  the
  604.     way that LIST reads the keyboard.  With PCED, for example,  pressing
  605.     the ESCape key at a prompt is different.  You do not see the /  that
  606.     DOS normally sends when you cancel and input line.
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625. Page  7                                                    LIST  User's Guide
  626. How to use LIST
  627. ______________________________________________________________________________
  628.  
  629. Display Format
  630.  
  631.     The monitor  display is  defined in  terms of  lines and columns.  A
  632.     typical  monitor  can  display  25  lines  of 80 columns each.  LIST
  633.     attempts to use the number of lines and columns for the monitor mode
  634.     in use.  For  example, if the  monitor is in  132 column mode,  LIST
  635.     displays 132 characters per line.   If the monitor is set  for other
  636.     than 25 lines, such as 35, 43, or 50 lines, LIST displays that  many
  637.     lines per screen.
  638.  
  639.     If  you  use  the  Alt-E  command  to  change EGA/VGA modes, the EGA
  640.     palette,  cursor,  and  other  settings  are  set to the DOS default
  641.     values.  LIST does not preserve fonts or palettes.
  642.  
  643.     The top line of the display  is called the Status line.  The  bottom
  644.     line is called the Command line.  The remaining lines are called the
  645.     primary display window, and are usually lines two through 24.
  646.  
  647.   Status Line Format
  648.  
  649.     The Status line has two formats. The default format is:
  650.  
  651. ┌──────────────────────────────────────────────────────────────────────┐
  652. │ LIST   lllll nnnnnnn +sss mm/dd/yy hh:mm  - filename                 │
  653. └──────────────────────────────────────────────────────────────────────┘
  654.         where,
  655.  
  656.         'LIST'     is the name of this program
  657.  
  658.         'lllllll'  is the line number of the first line in the primary
  659.                    display window (under the status line)
  660.  
  661.         'nnnnnnn'  is the line number of the last record of the file;
  662.                    if the last record of the file has not been read,
  663.                    this field is blank
  664.  
  665.         '+sss'     if displayed, this is the Scroll amount, in multiples
  666.                    of 10, corresponding to the number of columns that
  667.                    the display has been shifted to the right to view
  668.                    records longer than 80
  669.  
  670.         'mm/dd/yy' is the file's creation date (not today's date)
  671.         'hh:mm'    is the file's creation time (not today's time)
  672.  
  673.         'filename' is the name of the file you are currently viewing
  674.  
  675.  
  676.     Note: The date  and time shown  on the top  line is NOT  the current
  677.     date.  It is the date and time that the file was created.
  678.  
  679.           Thus, the Status Line could look like this:
  680. ┌──────────────────────────────────────────────────────────────────────┐
  681. │ LIST      70  2153  +20    09-02-89 18:12     LIST.DOC               │
  682. └──────────────────────────────────────────────────────────────────────┘
  683.  
  684.     By using the Alt-R ruler toggle, the bottom status line becomes:
  685.  
  686. ┬┬┬┬┼┬┬┬01┬┬┬┬┼┬┬┬02┬┬┬┬┼┬┬┬03┬┬┬┬┼┬┬┬04┬┬┬┬┼┬┬┬05┬┬┬┬┼┬┬┬06┬┬┬┬┼┬┬┬07┬┬
  687.  
  688.  
  689.  
  690. LIST  User's Guide                                                    Page  8
  691. How to use LIST
  692. ______________________________________________________________________________
  693.  
  694.   Command Line Format
  695.  
  696.  
  697. The Command line has two formats.  The default format is:
  698.  
  699. ┌──────────────────────────────────────────────────────────────────────┐
  700. │ Command                      Keys: ^v-><- PgUp PgDn F10=exit F1=Help │
  701. └──────────────────────────────────────────────────────────────────────┘
  702.  
  703. and the optional format after using the Alt-Z toggle is:
  704.  
  705. ┌──────────────────────────────────────────────────────────────────────┐
  706. │ Command                       Toggles: h8kMpswTclJ  F10=exit F1=Help │
  707. └──────────────────────────────────────────────────────────────────────┘
  708.  
  709.         where,
  710.  
  711.         'command' indicates the current process:
  712.  
  713.           'Command '   function prompt; you are being asked to enter
  714.                        a command; enter the letter, or press the keys
  715.                        for the action to be performed
  716.  
  717.           'Reading '   the file data is being read
  718.           'Filter  '   the file data is being formatted for display
  719.           'Looking '   the Scan/Find text is being searched for
  720.  
  721.           'Scan    '   you are being asked to enter text to locate
  722.           'Find    '   in the file, up to 31 characters may be entered
  723.  
  724.           '# lines?'   you are being asked to enter a 1 to 5 digit
  725.                        number that is the amount of lines to skip
  726.  
  727.           'Line #? '   you are being asked to enter a 1 to 5 digit
  728.                        line number to which the display is to be
  729.                        positioned
  730.  
  731.           'message' may be one of:
  732.  
  733.           '*** Text not found ***'
  734.            the Scan/Text was not found in the file
  735.  
  736.           '   *** Top of file ***'
  737.            the first line of the file is being displayed
  738.  
  739.           '   *** End-of-file ***'
  740.            the last line of the file is being displayed
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755. Page  9                                                    LIST  User's Guide
  756. How to use LIST
  757. ______________________________________________________________________________
  758.  
  759.   Command Line Format
  760.  
  761.         Toggles: indicate status of toggles, lower case means OFF, upper
  762.         case means the option is ON.
  763.  
  764.         'H'       indicates that the hex Dump display option is in use
  765.         'b'       the 'b' is replaced by a 7, 8, or * depending
  766.                   on which of those options is in effect
  767.         'K'       indicates that the Keyboard flush option is in use
  768.         'M'       indicates that tests for monitor retrace are not made
  769.         'P'       indicates that Print is in use
  770.         'S'       indicates file sharing option is in use
  771.         'W'       indicates that the Wrap mode is in effect
  772.         'T'       indicates that TAB characters are expanded
  773.         'C'       toggles continuous scrolling
  774.         'L'       indicates that the pre-loading option is on
  775.         'J'       indicates that line feeds are added to lone carriage
  776.                   return control characters, and backspaces are handled
  777.  
  778.         A sample Command Line might look like this, after looking for
  779.         a word that was not found:
  780.  
  781. ┌──────────────────────────────────────────────────────────────────────┐
  782. │ Command *** Text not found *** Toggles: h*kMpswTclJ  F10=exit F1=Help│
  783. └──────────────────────────────────────────────────────────────────────┘
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820. LIST  User's Guide                                                    Page  10
  821. How to use LIST
  822. ______________________________________________________________________________
  823.  
  824. Scrolling
  825.  
  826.  
  827.     You view different parts of the file by scrolling.  That is, you use
  828.     the cursor  positioning keys  up, down,  left and  right to move the
  829.     display one  increment in  that direction.   For example,  press the
  830.     down  arrow  key  to  move  the  display  one line in the file, i.e.
  831.     display the next line in the file.
  832.  
  833.  
  834.     The PgDn and PgUp  cursor keys move the  display one full screen  in
  835.     either direction.
  836.  
  837.  
  838.     Rather than press the up and  down keys once for each line,  you may
  839.     use  continuous  scrolling.   Use  the  C  key  to toggle continuous
  840.     scrolling on or off.  The default is off.  When toggled on, pressing
  841.     the up or down arrow keys results in a moving display.  For example,
  842.     when  you  press  the  down  arrow,  the  next  line  of the file is
  843.     displayed automatically  every second,  or so.   It is  like holding
  844.     down the arrow key.  To stop the continuous scroll, press the  space
  845.     bar.
  846.  
  847.  
  848.     The speed of the continuous scroll can be adjusted by pressing the +
  849.     (plus) or - (minus) key while  the display is moving.  The plus  key
  850.     makes  the  display  move  faster,  and  the minus key makes it move
  851.     slower.  You can save the  speed value by using the  cloning command
  852.     (see Configuring LIST, Cloning, later on in this documentation.
  853.  
  854.  
  855.         Summary of scrolling commands:
  856.  
  857.             right arrow - move display right 10 columns
  858.             left arrow  - move display left 10 columns
  859.  
  860.             down arrow  - display next line of file
  861.             up arrow    - display previous line of file
  862.  
  863.             PgUp key    - display previous "page", 23 (or 41) lines back
  864.             PgDn key    - display next "page", 23 (or 41) lines ahead
  865.  
  866.             C key       - turns continuous scrolling on or off
  867.             spacebar    - or any key, interrupts continuous scrolling
  868.             + (plus)    - makes continuous scroll incrementally faster
  869.             - (minus)   - makes continuous scroll slower
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885. Page  11                                                    LIST  User's Guide
  886. How to use LIST
  887. ______________________________________________________________________________
  888.  
  889. Positioning to Lines
  890.  
  891.  
  892.     Each displayable line  of the file  is assigned a  line number.  The
  893.     first line is  assigned line number  1.  The highest  allowable line
  894.     number is 16 million.
  895.  
  896.     In order to  determine the last  line number of  a file, the  entire
  897.     file must be  read.  For this  reason, the first  time that the  END
  898.     (bottom) command is issued, it will take longer to process.  This is
  899.     not necessary if  the file has  been completely read  (see the Alt-L
  900.     preloading option).
  901.  
  902.     If the Wrap option is in  effect, there is one line number  required
  903.     for each 80 bytes of the file's records.  Thus, the line number does
  904.     not represent the actual number of lines in the file.
  905.  
  906.     If  the  hex  dump  option  is  in  effect, there is one line number
  907.     required for  each 16  bytes of  the file.   For example, an 80-byte
  908.     line will be displayed as 5 lines.
  909.  
  910.     You may position to a  specific line number by using  the Ctrl-Home,
  911.     or the # key.  When Ctrl-Home  is entered, you are prompted for  the
  912.     line number.   Enter the  line number.   The display  will now begin
  913.     with that line number at the top of the screen.
  914.  
  915.     To position  forward or  backward, you  may use  the +  (plus), or -
  916.     (minus) keys.  You are prompted to  enter the number of lines to  be
  917.     skipped.  The display  resumes at the  line number shown  on the top
  918.     (status) line, plus or minus the number of lines that you specified.
  919.  
  920.     When you change  a filter option,  such as Wrap,  the line numbering
  921.     changes.  An attempt is made  to retain the same file  position, but
  922.     the file may be repositioned at the top.
  923.  
  924.     You may also reposition to the last "active" line by using the Alt-Y
  925.     bookmark command.   The last  active line  is one  displayed after a
  926.     Scan or Find command, or marked using the Alt-M or Alt-B commands.
  927.  
  928.  
  929.     Summary of positioning commands:
  930.  
  931.         Ctrl-HOME, or #  - Prompts for exact line number to display
  932.  
  933.         + (plus)         - Prompts for the number of lines to skip
  934.                            for positioning further ahead in the file
  935.  
  936.         - (minus)        - Prompts for the number of lines to skip
  937.                            for positioning to an earlier line
  938.  
  939.         Alt-Y            - Reposition to the last "active" line
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950. LIST  User's Guide                                                    Page  12
  951. How to use LIST
  952. ______________________________________________________________________________
  953.  
  954. Filtering
  955.  
  956.  
  957.     Filtering is the term used to describe the process that LIST uses to
  958.     format file data  for displaying on  a monitor.  After  data is read
  959.     from a file, it is  filtered.  The method of filtering  depends upon
  960.     the options in effect.
  961.  
  962.     For a typical  ASCII text file,  the filter removes  carriage return
  963.     and line feed characters, and expands TAB characters.
  964.  
  965.     Because files  contain different  kinds of  data, there  are several
  966.     commands to  tell LIST  how to  display the  data.  The process that
  967.     LIST uses to make the  file data readable is called  filtering.  The
  968.     filters in LIST can:
  969.  
  970.             o  replace non-text and control characters with blanks
  971.             o  expand TAB characters
  972.             o  display line drawing characters
  973.             o  change 8-bit (W*) data to readable 7-bit text **
  974.             o  display the hexidecimal values for each character
  975.             o  remove "junk", such as control codes and backspaces
  976.  
  977.            **  W* is an abbreviation for WordStar (tm) formatted files
  978.                which contain 'high-bit' characters. Using the '*' filter
  979.                makes these files easier to read.
  980.  
  981.     LIST was designed primarily to display ASCII files.  That is,  files
  982.     which  contain  text,  and  not  binary  or  control  codes.    Text
  983.     characters, like A-Z and 0-9,  which ar in the 7-bit  range.  Binary
  984.     files, like  .COM and  .EXE files,  contain the  full range of 8-bit
  985.     characters.   To  view  binary  files  the  Alt-H (hex dump display)
  986.     command is available.
  987.  
  988.     Characters  above  127  (the  8-bit  range)  may  be  valid  graphic
  989.     characters, and may  be displayed if  the '8' command  is in effect.
  990.     To insure that characters above  ASCII value 127 are NOT  displayed,
  991.     use the '7' command to limit the display to characters in the  7-bit
  992.     range.
  993.  
  994.  
  995.   Wrap Filter
  996.  
  997.     The file is displayed with one logical record on each display  line:
  998.     usually 80 characters.  A logical record ends in a linefeed and  may
  999.     be up to  910 characters long.   If a record  exceeds 80 characters,
  1000.     you may view the portion beyond  the 80 columns by using the  scroll
  1001.     right command, or by using  the Wrap feature.  The Wrap  (W) command
  1002.     toggles ON or OFF the  wrapping of lines longer than  80 characters.
  1003.     With Wrap on, lines are  displayed in their entirety, 80  characters
  1004.     per  display  line.   The  scroll  left  (arrow)  and  right (arrow)
  1005.     functions are disabled when Wrap is ON.
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015. Page  13                                                    LIST  User's Guide
  1016. How to use LIST
  1017. ______________________________________________________________________________
  1018.  
  1019. Filtering
  1020.  
  1021.  
  1022.   Hi-bit Filter
  1023.  
  1024.     The 7,  8, and  * (asterisk)  commands determine  whether characters
  1025.     above  ASCII-127  are  displayed.   If  the  hi-bit option is off (7
  1026.     command), the filter strips the high order bit from each  character.
  1027.     If the hi-bit  option is on  (8 command), all  characters, including
  1028.     graphic characters above ASCII-127, are displayed.
  1029.  
  1030.  
  1031.   Star Filter
  1032.  
  1033.     The  star  (*  or  asterisk)  command displays only ASCII characters
  1034.     below 128 (x'80'), but treats the special characters x'8A' and x'8D'
  1035.     as  line-feed  and  carriage-return  control  characters.  Any other
  1036.     characters above 127 are treated as spaces, and control codes  below
  1037.     ASCII-26 are replaced by blanks.
  1038.  
  1039.  
  1040.   Junk Filter
  1041.  
  1042.     The  Alt-J  command  toggles  the  "junk"  filter which insures that
  1043.     carriage  returns  in  the  file  also  result in a new line.  Also,
  1044.     backspace  characters  result  in  "backing  up"  the display by one
  1045.     position.   This   allows  more   readability  of   files  that  use
  1046.     backspacing to emphasize, or over-write, characters.
  1047.  
  1048.  
  1049.   Hex Format Filter
  1050.  
  1051.     The hex  dump option  (Alt-H) causes  the filtering  to reformat the
  1052.     file data into a DEBUG-like  display format.  The largest file  that
  1053.     can be displayed in Hex is 4 million bytes.
  1054.  
  1055.     An attempt is made to  retain the file position when  switching from
  1056.     normal to  hex-dump display,  but due  to filtering  changing record
  1057.     lengths, the hex display may begin before the current record.
  1058.  
  1059.  
  1060.                 Summary of filtering commands:
  1061.  
  1062.         8       show all characters as-is
  1063.         7       strip the hi-bit from each character
  1064.         *       use the star filter to remove control characters
  1065.                 and some special word processor characters
  1066.  
  1067.         Alt-J   use the "junk" filter
  1068.         Alt-H   use the "hex" filter to display in hex dump format
  1069.         Alt-T   expand TAB control characters
  1070.         Alt-W   wrap long lines to fit on screen
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080. LIST  User's Guide                                                    Page  14
  1081. How to use LIST
  1082. ______________________________________________________________________________
  1083.  
  1084. Scanning for text
  1085.  
  1086.  
  1087.     There are three ways  to initiate a search  for text.  First is  the
  1088.     Find (\ or F) command.  Use this command to search for text  without
  1089.     regard to the case (upper or  lower) of the letters.  Second is  the
  1090.     Scan (/ or S) command.  Use  this command to search an exact  match.
  1091.     That is, the search is case sensitive.
  1092.  
  1093.     The third way to initiate a  search for text is with the  /F command
  1094.     line switch.  With it, you supply  the text to search for, and  LIST
  1095.     begins the search before displaying the file, and before asking  for
  1096.     commands.  The search continues  through all selected files  until a
  1097.     match is found, or the last file has been searched.  This search  is
  1098.     case sensitive.
  1099.  
  1100.     Each search begins at  the line displayed on  the top of the  screen
  1101.     and proceeds in a forward direction until the end of file.  You  may
  1102.     start a search that goes backwards rather than forwards by using the
  1103.     ` (left quote) key instead of Find (\), or by using ' (right  quote)
  1104.     instead of Scan (/).
  1105.  
  1106.     To enter the Scan search text, type a slash (/) followed by up to 31
  1107.     characters.  The Scan  text is displayed  on the command  line.  The
  1108.     Scan is  case sensitive.   That is,  lower case  Scan text will only
  1109.     match lower case file text.
  1110.  
  1111.     While the program is searching for the text, the bottom display line
  1112.     is changed to say "Looking".   Pressing ANY key while the  search is
  1113.     in progress will terminate the search and display the message  'Text
  1114.     not found' on the bottom line.
  1115.  
  1116.     If the  text is  found, the  line containing  it is  displayed as  a
  1117.     high-intensity line (bright color) in  the middle of the screen  The
  1118.     line where the found text is displayed depends on the setting of the
  1119.     "Find Row" (see Configuration section).
  1120.  
  1121.     The display is scrolled left or right, as needed, so that the  found
  1122.     text is visible.
  1123.  
  1124.     If the text is  NOT found, the command  line is changed to  say '***
  1125.     Text not found ***', and the rest of the display remains unchanged.
  1126.  
  1127.     To  find  the  next  occurrence  of  the  same  text, use the A)gain
  1128.     command, or press the  F3 key.  If you  wish to continue the  search
  1129.     through all of the remaining files, use the Alt-A command.  To  find
  1130.     the previous occurrence, press the F9 key.
  1131.  
  1132.     If the a keyboard enhancement  program, such as PCED, is  installed,
  1133.     the up/down cursor  keys may be  used to recall  and edit previously
  1134.     entered Scan/Find text.
  1135.  
  1136.     In  a  shared  file  environment,  if  the  file changes while being
  1137.     listed, the file position may become invalid.  Use the HOME  command
  1138.     to  insure  proper  file  synchronization,  or  use the Alt-S (share
  1139.     files) command again.
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145. Page  15                                                    LIST  User's Guide
  1146. How to use LIST
  1147. ______________________________________________________________________________
  1148.  
  1149.   Summary of scanning commands:
  1150.  
  1151.  
  1152.  
  1153.  
  1154.                 /       Scan for text with exact match
  1155.  
  1156.                 v or '  Scan for text going backwards
  1157.  
  1158.  
  1159.                 \       Find text with case insensitive search
  1160.  
  1161.                 ^ or `  Find case insensitive text going backwards
  1162.  
  1163.  
  1164.                 F3      Find next occurrence of text
  1165.  
  1166.                 F9      Find previous occurrence of text
  1167.  
  1168.  
  1169.                 Alt-A   Scan for next occurrence of the text, and continue
  1170.                         on to the next file until the text is found
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210. LIST  User's Guide                                                    Page  16
  1211. How to use LIST
  1212. ______________________________________________________________________________
  1213.  
  1214. Marking and Extracting Lines
  1215.  
  1216.  
  1217.     There are two ways that lines can be extracted from a file:
  1218.  
  1219.               o  with the P (print) and Alt-P (print marked) commands,
  1220.               o  with the Alt-D (dump data) and Alt-O commands.
  1221.  
  1222.     The  lines  to  be  extracted  are  either  the current lines on the
  1223.     screen,  or  lines  that  you  have  marked with the Alt-M and Alt-B
  1224.     commands.
  1225.  
  1226.     To mark  lines, you  use either  the Alt-M  or Alt-B  commands.  The
  1227.     Alt-M command marks the top line on the screen, and Alt-B marks  the
  1228.     bottom line on the screen.  You  can use either or both commands  to
  1229.     mark the  starting and  ending lines  (in the  range of  lines to be
  1230.     extracted).  The marked lines are displayed in reverse video.
  1231.  
  1232.     After you have marked  a range of lines,  you use the Alt-P  (print)
  1233.     command to print all of the marked lines.  Or, you can use the Alt-D
  1234.     (dump  data)  command  to  write  those  lines to a file.  The Alt-D
  1235.     command asks you for a file name.  If the file does not exist, a new
  1236.     one is created.  If the file already exists, the extracted lines are
  1237.     added (appended) to the file.
  1238.  
  1239.     For example, you would like to have LIST filter out all of the  junk
  1240.     in a file, and then write a  new file.  To do this, you might  enter
  1241.     the following sequence of commands:
  1242.  
  1243.                 list TESTDATA           ... display your TESTDATA file
  1244.                 Alt-J                   ... filters out the junk
  1245.                 Alt-M                   ... marks line 1 (top line)
  1246.                 END                     ... positions to end of file
  1247.                 Alt-B                   ... marks the bottom line
  1248.                                                      (last line)
  1249.                 Alt-D                   ... dumps data to a file
  1250.                 TESTDATE.NEW            ... you enter the new file name
  1251.                 Alt-X                   ... quit and return to DOS
  1252.  
  1253.  
  1254.     Once you have marked  a range of lines,  use of Alt-M or  Alt-B does
  1255.     not reset the entire line range.  The first or last marked line  may
  1256.     change,  but  both  do  not  change.   Using  Alt-M again expands or
  1257.     contracts the range appropriately.  If the new line for  Alt-M/Alt-B
  1258.     is before the top mark, the top  mark is moved.  If the new line  is
  1259.     after the bottom mark, the bottom mark is changed.  If the new  line
  1260.     is within  the currently  marked range,  Alt-M moves  the top mark -
  1261.     contracts the range - and Alt-B moves the bottom mark.
  1262.  
  1263.  
  1264.     Use the Alt-U command to unmark lines, especially after Alt-D (dump)
  1265.     to be sure.
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275. Page  17                                                    LIST  User's Guide
  1276. How to use LIST
  1277. ______________________________________________________________________________
  1278.  
  1279. Printing
  1280.  
  1281.  
  1282.     The file may be PRINTed as it is displayed, in its entirety, or from
  1283.     a range of lines that you  mark.  If the printer is not  online, you
  1284.     will receive an error message, and nothing will be printed.
  1285.  
  1286.     The P command  toggles the printer  on or off.   When first entered,
  1287.     the P command causes the current screen to be printed.  As new lines
  1288.     are displayed, they too are printed.  For example, pressing the down
  1289.     arrow will display and print the next line of the file.
  1290.  
  1291.     Printing may be  stopped by entering  another P command.   The PrtSc
  1292.     key may also be used, but the title and prompt lines will be printed
  1293.     with the lines of the file.  Empty lines cause a line to be  skipped
  1294.     on the  printer.  The  capital letter  P is  displayed on the status
  1295.     line while printing.
  1296.  
  1297.     The Ctrl-P command prints the file in its entirety.
  1298.  
  1299.     The Ctrl-F command  sends a form  feed to the  printer.  The printer
  1300.     may be the LPT1 or PRN device.
  1301.  
  1302.     The Alt-P command prints only lines that have been marked.
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340. LIST  User's Guide                                                    Page  18
  1341. How to use LIST
  1342. ______________________________________________________________________________
  1343.  
  1344. Displaying multiple files
  1345.  
  1346.  
  1347.     You can display more than one  file at a time.  LIST keeps  track of
  1348.     up to 32 files at a  time.  You supply the filenames in  the command
  1349.     line,  through  the  Alt-F  (get  new filespec) command, through the
  1350.     Alt-I  (insert  filespec)  command,  and  through  the  Alt-V   file
  1351.     selection menu.
  1352.  
  1353.     You  can  specify  up  to  16  filespecs  on the command line.  Each
  1354.     filespec can contain wildcards.  Thus, several files can be selected
  1355.     via the command line.  For example,
  1356.  
  1357.                           LIST *.DOC  *.TXT
  1358.  
  1359.     will display all files with an extension of DOC and TXT.
  1360.  
  1361.     To display the next file, you use the Q or Ctrl-PgDn command.   When
  1362.     the last file has been displayed, you can exit LIST by using the  X,
  1363.     F10, ESCape, or Alt-X commands, depending on how you want the screen
  1364.     to look when LIST ends.
  1365.  
  1366.     To display  the previous  file, you  use the  Ctrl-PgUp (control and
  1367.     PgUp keys together).  LIST can keep  track of up to 32 files  at one
  1368.     time.  The line number for each file is remembered.
  1369.  
  1370.  
  1371.     The Alt-F asks you for a new  file name, and you may enter a  simple
  1372.     file name, or  one that includes  wild cards.  These  new file names
  1373.     are added to the table of filenames that LIST keeps.  Thus, you  can
  1374.     use Alt-F for several different filenames, and use the Ctrl-PgDn and
  1375.     Ctrl-PgUp commands to move among them.
  1376.  
  1377.     The Alt-I command  allows you to  select a filespec  that is in  the
  1378.     file you are  viewing.  You position  the cursor to  the filespec on
  1379.     the  screen,  and  press  enter  to  add  it to the list of files to
  1380.     display.
  1381.  
  1382.     The Alt-V command displays a list of file in the current  directory.
  1383.     You move the cursor  to a file that  you want to display,  and press
  1384.     enter to add that file to the list.
  1385.  
  1386.  
  1387.     Summary of file review commands:
  1388.  
  1389.         Q               - display next file; if none, display the last file
  1390.  
  1391.         Ctrl-PgUp       - display previous file
  1392.  
  1393.         Ctrl-PgDn       - display next file
  1394.  
  1395.         Alt-F           - prompt for new filename or filespec to display
  1396.  
  1397.         Alt-I           - insert a filespec that is displayed
  1398.  
  1399.         Alt-V           - select a file from a menu
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405. Page  19                                                    LIST  User's Guide
  1406. How to use LIST
  1407. ______________________________________________________________________________
  1408.  
  1409. Windows
  1410.  
  1411.  
  1412.     LIST can  display data  in one  or two  parts of  the screen  called
  1413.     windows.   The  Alt-W  command  toggles  this  split  screen   mode.
  1414.     Entering Alt-W while the screen  is split restores the display  to a
  1415.     single, full sized display.
  1416.  
  1417.     In the regular version, the screen is split in the middle.  The  top
  1418.     half of the screen remains the same, and the bottom half becomes the
  1419.     part of the screen where files are diaplayed.  Thus, the top  window
  1420.     becomes a scratch pad.
  1421.  
  1422.     In the LIST PLUS version, you are allowed to split the screen at any
  1423.     point.  After entering Alt-W, you  are asked to position the  cursor
  1424.     to the spot where the screen  will be split.  By placing the  cursor
  1425.     in column 1, you can adjust how  many lines will be used by the  top
  1426.     and bottom windows.  This would  be a vertical, or one  window above
  1427.     the other, split.
  1428.  
  1429.     By positioning the cursor to the top line with the HOME key, you can
  1430.     then use the left  and right arrow keys  to adjust how wide  each of
  1431.     the windows is to be.   This would be a horizontal,  or side-by-side
  1432.     split.
  1433.  
  1434.     You may display  a different file  in each window,  and move between
  1435.     them.  You use the Ctrl-V command  to switch from one window to  the
  1436.     other.  You may also use the Review commands to display a  different
  1437.     file in the second window.
  1438.  
  1439.     Each window uses different colors.   You can use the color  commands
  1440.     to set the colors that you  like, and then use the Alt-C  command to
  1441.     save them.
  1442.  
  1443.  
  1444. Telephone dialer
  1445.  
  1446.     LIST has a simple telephone dialer function.  It allows you to point
  1447.     to a telephone number that is  displayed on the screen, and to  send
  1448.     dialing commands to your modem on COM1.
  1449.  
  1450.  
  1451.     You use the  Ctrl-T command to  start the dialer.   You position the
  1452.     cursor, with the arrow  keys, to the start  of the phone number  and
  1453.     press enter.  The phone number  may contain any character, but  must
  1454.     end with a blank.
  1455.  
  1456.     If the phone rings, you may pick up your telephone.  Otherwise,  you
  1457.     may press <enter> to return to viewing the file, <spacebar> to  dial
  1458.     the number again, or ESCape to hang up and stop dialing.
  1459.  
  1460.     The Ctrl-H command hangs up the telephone.
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470. LIST  User's Guide                                                    Page  20
  1471. DOS considerations
  1472. ______________________________________________________________________________
  1473.  
  1474.  
  1475. File Sharing
  1476.  
  1477.     LIST uses two techniques for allowing you to share files with  other
  1478.     processes, such as programs running under multi-tasking systems,  in
  1479.     other windows, or on networks.
  1480.  
  1481.     The first technique is called  "file closing" and is enabled  by the
  1482.     Alt-S commands.  This forces LIST to close the viewed file unless it
  1483.     needs to  read from  the file.   If enough  memory is available, the
  1484.     entire file  may be  loaded once  and thus  leave the  file free for
  1485.     exclusive access by other processes.
  1486.  
  1487.     The second technique is called "file sharing".  It is a function  of
  1488.     DOS and requires  DOS version 3.0  or later.  LIST  opens the viewed
  1489.     files with a DENY NONE request.  This allows other processes to read
  1490.     and write to the  file if they do  not request exclusive use  of the
  1491.     file.  If a file  is not available to  LIST because it is  locked by
  1492.     another process, you will receive the error message "File not found"
  1493.     or "Access denied".  There is  no command to enable or  disable this
  1494.     method of file sharing.  It is implicit with the use of DOS  version
  1495.     3 and later.
  1496.  
  1497.  
  1498.  
  1499. Invoking DOS Commands
  1500.  
  1501.     If the "goto DOS" option is enabled, you may invoke DOS commands  by
  1502.     using the Alt-G command.  LIST reserves about 60k of memory for  its
  1503.     own use.  This increases LIST's memory requirements to approximately
  1504.     96k when using Alt-G.  The remaining memory is available to the  DOS
  1505.     commands.
  1506.  
  1507.  
  1508.     After you  have finished  entering DOS  commands, use  the DOS  EXIT
  1509.     command to return to LIST.
  1510.  
  1511.     To disable the "goto DOS" function, you must use DEBUG to alter  the
  1512.     option  byte  described  in  the  section  about  cloning.   With it
  1513.     disabled, LIST requires less memory, about 66K.
  1514.  
  1515.  
  1516.  
  1517. Screen Saving
  1518.  
  1519.     If the screen saving option  is enabled, LIST saves the  contents of
  1520.     the current  display screen  when it  starts.  You  can restore  the
  1521.     original screen by exiting LIST with the Alt-X command.
  1522.  
  1523.     Screen  saving  requires  approximately  10k  more  memory.  This is
  1524.     sufficient to save  60 lines of  80 characters (EGA  8x6 mode).  See
  1525.     the section about Configuring LIST and cloning for information about
  1526.     enabling and disabling the screen saving feature.
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535. Page  21                                                    LIST  User's Guide
  1536. File Selection Menu
  1537. ______________________________________________________________________________
  1538.  
  1539. LIST PLUS Display
  1540.  
  1541.  
  1542.     LIST PLUS has several new functions that greatly enhance the  things
  1543.     that you can do.  If you load the file LISTP.COM (LIST PLUS) with no
  1544.     file specification, you would see something like this:
  1545.  
  1546. ┌──────────────────────────────────────────────────────────────────────┐
  1547. │ LIST - File Selection        1 of 40      Path: C:\*.*               │
  1548. └──────────────────────────────────────────────────────────────────────┘
  1549.  ^..         ░            ░
  1550.  vWPW        ░WPSMALL .DRS░
  1551.  vMAIN       ░            ░
  1552.  vWORK       ░            ░
  1553.  CONVERT .EXE░WPWSTAR .HLP░
  1554.  STANDARD.PRS░WP}WP{  .TV1░
  1555.  WP      .EXE░STORY   .DOC░
  1556.  WP      .FIL░FINDER  .LTR░
  1557.  WP      .MRS░            ░
  1558. ┌──────────────────────────────────────────────────────────────────────┐
  1559. │ List Copy Delete Move  Path  Rename  Viewarc  Sort  1-6 up  Esc=Exit │
  1560. └──────────────────────────────────────────────────────────────────────┘
  1561.  
  1562.     Note that the Command Line contains the following choices:
  1563.  
  1564.        LIST, COPY, DELETE, MOVE, PATH, RENAME, VIEWARC, SORT, 1-6 up
  1565.  
  1566.     Each of these commands may be executed from within LIST PLUS and are
  1567.     described below.
  1568.  
  1569.  
  1570. Movement Keys
  1571.  
  1572.     Use the arrow keys to move  the cursor to a filename.  The  filename
  1573.     at  the  cursor  is  highlighted.   The  other  cursor  and filename
  1574.     selection keys are:
  1575.  
  1576.                 PgDn            - displays the next page of files
  1577.                 PgUp            - displays the previous page of files
  1578.  
  1579.                 HOME            - positions to the first filename
  1580.                                   on the screen
  1581.                 END             - positions to the last filename
  1582.                                   on the screen
  1583.  
  1584.                 Ctrl-HOME       - positions to the first filename
  1585.                 Ctrl-END        - positions to the last filename
  1586.  
  1587.                 F1              - displays a Help screen
  1588.                 ESCape          - exits to DOS
  1589.                 Q               - exits to DOS with the screen restored
  1590.                                   to what it was before running LIST
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600. LIST  User's Guide                                                    Page  22
  1601. File Selection Menu
  1602. ______________________________________________________________________________
  1603.  
  1604. LIST PLUS Display
  1605.  
  1606.  
  1607. Changing Directories
  1608.  
  1609.     Any subdirectories contained  in the current  directory will have  a
  1610.     down arrow  next to  them.  If  you highlight  one of  these and hit
  1611.     Enter you will go to that directory.  If the directory that you  are
  1612.     in  is  a  subdirectory  itself,  there  will  be an up arrow .. and
  1613.     selecting this will take you  up.  Thus, you can easily  move around
  1614.     your hard disk from within LIST!
  1615.  
  1616.  
  1617. List file
  1618.  
  1619.     This invokes LIST just as  you would from DOS. Simply  highlight the
  1620.     file that you wish to view, enter a carriage return, and you will be
  1621.     in LIST looking  at the selected  file.  When you  are finished, you
  1622.     may escape back to the original screen, with all of it's options.
  1623.  
  1624.     You may also open  a window and then,  using the Alt-V command,  get
  1625.     another  file  directory  and  select  another  file to view.  Using
  1626.     Alt-W, you can load more than two files.
  1627.  
  1628.  
  1629. Copy file
  1630.  
  1631.     This  function  allows  you  to  copy  the  selected  file  to a new
  1632.     subdirectory.  Highlight the file you want to copy and press  ENTER.
  1633.     You will be  prompted for the  new path where  you want to  copy the
  1634.     selected file  to.  Enter  the path,  press ENTER,  and the  file is
  1635.     copied to the directory you indicated.
  1636.  
  1637.  
  1638. Delete file
  1639.  
  1640.     Allows  you  to  delete  any  file  in  the current directory.  Just
  1641.     highlight the  file you  want to  delete and  press ENTER.  You will
  1642.     then be prompted  to make sure  that you want  to delete this  file.
  1643.     Enter Y if you do, and N if you do not.
  1644.  
  1645.  
  1646. Move file
  1647.  
  1648.     Move  any  file  in  the  current  directory to any other directory.
  1649.     Select the file that you want to move by highlighting it and hitting
  1650.     ENTER.  You will then  be prompted for a  new path.  Enter the  path
  1651.     and the file is moved to it's new location.
  1652.  
  1653.  
  1654. Path changing
  1655.  
  1656.     This function allows  you to switch  to ANY other  directory on your
  1657.     system without having to exit LIST!  Enter 'P' for Path, and type in
  1658.     the full path of the directory that you would like to change to, for
  1659.     example: C:\DNLD.  You will find yourself in the selected  directory
  1660.     and still within LIST.
  1661.  
  1662.  
  1663.  
  1664.  
  1665. Page  23                                                    LIST  User's Guide
  1666. File Selection Menu
  1667. ______________________________________________________________________________
  1668.  
  1669. LIST PLUS Display
  1670.  
  1671.  
  1672. Rename
  1673.  
  1674.     Using  this  function  you  can  rename  any  file  in  the  current
  1675.     directory.  Highlight the  file that you  want to rename.   You will
  1676.     then be prompted for  the new file name.   After you have entered  a
  1677.     new file name,  you will be  prompted to make  sure that you  really
  1678.     want to rename this file.  If so, then respond with a 'Y'; if you've
  1679.     changed  your  mind,  just  answer  with  an  'N'  and  the renaming
  1680.     procedure will be abandoned.
  1681.  
  1682.  
  1683. Sort filenames
  1684.  
  1685.     Allows you to sort the files in the current directory by file  name,
  1686.     extension, date, or size.  Once you have completed the operation you
  1687.     will find yourself back at the menu screen of LIST.
  1688.  
  1689.  
  1690. 1-6 up display
  1691.  
  1692.     This function lets you set the display to anywhere from 1 to 6  file
  1693.     names per line.   In subdirectories with  few numbers of  files, you
  1694.     will begin to see not only file name, but file size, date, and  time
  1695.     as well.  You can customize this so that it suits your tastes.
  1696.  
  1697.  
  1698. ViewArc
  1699.  
  1700.     This function will let you  view the directory of an  archive (.ARC,
  1701.     .ZIP, etc.) file, or self-extracting .COM and .EXE archive files.
  1702.  
  1703.     After you have viewed the desired file's directory, press ESCape  to
  1704.     return to the  file selection menu,  or use the  Alt-I (insert file)
  1705.     command to display a file within the archive file.
  1706.  
  1707.  
  1708.  
  1709.  
  1710.             To view  archive directories,  the program  FV.COM is
  1711.             required.  It must be located in a directory included
  1712.             in your PATH.
  1713.  
  1714.  
  1715.             To display files within an ARChive file, the  program
  1716.             ARCE.COM is required.  It must be in your PATH.   For
  1717.             ZIP files, the program PKUNZIP  must  be in your PATH.
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730. LIST  User's Guide                                                    Page  24
  1731. Command key summary
  1732. ______________________________________________________________________________
  1733.  
  1734. Cursor keys
  1735.  
  1736.  
  1737.         Cursor key      Function
  1738.         -----------     -----------------------------------------------
  1739.  
  1740.         left arrow      scroll left 10 columns
  1741.         right arrow     scroll right 10 columns
  1742.  
  1743.         up arrow        up one (previous) line
  1744.         down arrow      down one (next) line
  1745.  
  1746.         Enter           continue to next page
  1747.  
  1748.         END             position to end of file (bottom)
  1749.  
  1750.         ESCape          Exit program unconditionally
  1751.  
  1752.         HOME            restart from first line (top)
  1753.  
  1754.         PgUp            scroll up one page, 23 lines
  1755.         PgDn            scroll down one page, 23 lines
  1756.  
  1757.  
  1758. F- function keys
  1759.  
  1760.         Function key    Function
  1761.         ------------    ---------------------------------------------------
  1762.  
  1763.          F1             Displays the HELP screen
  1764.  
  1765.          F3             Find NEXT occurrence of text after Scan or Find
  1766.  
  1767.          F9             FInd the PREVIOUS occurrence of text
  1768.  
  1769.          F10            Exit to DOS
  1770.  
  1771.          For changing display colors:
  1772.  
  1773.          F2             Change background color for Find/Scan text
  1774.          F4             Change foreground color for Find/Scan text
  1775.  
  1776.          F5             Change background color for main body of display
  1777.          F6             Change foreground color for main body of display
  1778.  
  1779.          F7             Change background color for top and bottom lines
  1780.          F8             Change foreground color for top and bottom lines
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795. Page  25                                                    LIST  User's Guide
  1796. Command key summary
  1797. ______________________________________________________________________________
  1798.  
  1799. Letter keys
  1800.  
  1801.  
  1802.     The Letter key commands are  mnemonic.  That is, the letter  in some
  1803.     way, indicates what the command does.
  1804.  
  1805.         Letter(s)      Function
  1806.         ---------     -----------------------------------------------
  1807.  
  1808.         A            Find next occurrence of 'text' (Again)
  1809.  
  1810.         B            Skip to end of file (Bottom)
  1811.  
  1812.         C            Toggles Continuous scrolling
  1813.  
  1814.         D            Scroll Down one page
  1815.  
  1816.         F            Find 'text' regardless of case
  1817.  
  1818.         G            Get new filename/filespec (also Alt-F)
  1819.  
  1820.         H            Display the Help screen.
  1821.  
  1822.         K            Toggles keyboard key-ahead.
  1823.  
  1824.         L            Scroll LEFT 10 columns
  1825.  
  1826.         M            Toggles Monitor retrace testing to eliminate snow
  1827.  
  1828.         N            Down one (Next) line
  1829.  
  1830.         P            Toggles the printing of displayed lines.
  1831.  
  1832.         Q            Quits current file and displays next file, if any
  1833.  
  1834.         R            Scroll Right 10 columns. command,  the  'R' command
  1835.  
  1836.         S            Scan for exact text match, case dependent
  1837.  
  1838.         T            Restart from first line (Top)
  1839.  
  1840.         U            Scroll Up one page (23 lines)
  1841.  
  1842.         W            Toggles the Wrap option for displaying long lines
  1843.  
  1844.         X            Terminate, clear screen and eXit to DOS
  1845.  
  1846.         Z            Display the previous file.
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860. LIST  User's Guide                                                    Page  26
  1861. Command key summary
  1862. ______________________________________________________________________________
  1863.  
  1864. Letter keys
  1865.  
  1866.         7            Toggles the 7-bit filter
  1867.  
  1868.         8            Toggles the 8-bit filter
  1869.  
  1870.         *            Toggles the start filter
  1871.  
  1872.         +            Position a given number of lines forwards
  1873.  
  1874.         -            Position a given number of lines backwards
  1875.  
  1876.         ?            Displays the Help screen
  1877.  
  1878.         space        Scrolls down one page
  1879.  
  1880.         \text        Find any case 'text' going forwards
  1881.  
  1882.         /text        Scan exact case 'text' going forwards
  1883.  
  1884.         ` or ^       Find any case 'text' going backwards
  1885.  
  1886.         ' or v       Find exact case 'text' going backwards
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925. Page  27                                                    LIST  User's Guide
  1926. Command key summary
  1927. ______________________________________________________________________________
  1928.  
  1929. Control- keys
  1930.  
  1931.  
  1932.     The Ctrl- key commands are entered  by pressing the Ctrl key at  the
  1933.     same time as you press one of the following letter keys:
  1934.  
  1935.         Control key     Function
  1936.         -----------     ---------------------------------------------------
  1937.  
  1938.         Ctrl-HOME       Position to a specific line by number
  1939.  
  1940.         Ctrl-PgDn       Display next file
  1941.  
  1942.         Ctrl-PgUp       Display previous file
  1943.  
  1944.         Ctrl-left       Reset display to column 1, i.e. scroll full left
  1945.  
  1946.         Ctrl-A          Scroll full left
  1947.  
  1948.         Ctrl-C          Display next page, scroll down
  1949.  
  1950.         Ctrl-D          Scroll right 10 columns
  1951.  
  1952.         Ctrl-E          Display previous line, scroll up 1 line
  1953.  
  1954.         Ctrl-F          Send a formfeed control character to the printer
  1955.  
  1956.         Ctrl-H    **    Hang up the telephone
  1957.  
  1958.         Ctrl-N          Display previous file
  1959.  
  1960.         Ctrl-P          Print the entire file
  1961.  
  1962.         Ctrl-R          Display previous page, scroll up
  1963.  
  1964.         Ctrl-S          Scroll left 10 columns
  1965.  
  1966.         Ctrl-T    **    Dial a telephone number
  1967.  
  1968.         Ctrl-U          Display previous file
  1969.  
  1970.         Ctrl-V    **    Switch display windows
  1971.  
  1972.         Ctrl-W          Display previous line, scroll up one line
  1973.  
  1974.         Ctrl-X          Display next line, scroll down one line
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990. LIST  User's Guide                                                    Page  28
  1991. Command key summary
  1992. ______________________________________________________________________________
  1993.  
  1994. Alt- keys
  1995.  
  1996.     The Alt- key  commands are entered  by pressing the  Alt key at  the
  1997.     same time as you press one of the following letter keys:
  1998.  
  1999.     Alt- letter      Function
  2000.     -----------      ---------------------------------------------------
  2001.  
  2002.      Alt-A           Search for next occurrence of text, continue to next
  2003.                      file until found
  2004.  
  2005.      Alt-B           Mark bottom line of display
  2006.  
  2007.      Alt-C           Copy options and setting to LIST.COM
  2008.  
  2009.      Alt-D           Write marked lines to a file
  2010.  
  2011.      Alt-E           Toggle 25 or 43/50 line display with EGA or VGA
  2012.  
  2013.      Alt-F           Enter additional filenames to display
  2014.  
  2015.      Alt-G           Goto DOS temporariliy to enter DOS commands
  2016.  
  2017.      Alt-I    **     Insert a filespec from the screen display
  2018.  
  2019.      Alt-H           Toggle Hex display mode
  2020.  
  2021.      Alt-J           Toggle the "junk" filter
  2022.  
  2023.      Alt-L           Toggle preloading of files
  2024.  
  2025.      Alt-M           Mark the line at the top of the display
  2026.  
  2027.      Alt-N           Toggle the Alt-X screen saving feature
  2028.  
  2029.      Alt-O           Write marked lines to the same file used by Alt-D
  2030.  
  2031.      Alt-R           Toggle the display of a ruler line on top line
  2032.  
  2033.      Alt-S           Toggle the file Sharing option
  2034.  
  2035.      Alt-T           Toggle the TAB control character filer
  2036.  
  2037.      Alt-U           Unmark lines marked by Alt-M and Alt-B
  2038.  
  2039.      Alt-V    **     Invoke the File Selection Menu
  2040.  
  2041.      Alt-W           Toggle split screen
  2042.  
  2043.      Alt-X           Exit  to DOS  and display  the original screen
  2044.  
  2045.      Alt-Y           Repostion to the last "active" line (bookmark)
  2046.  
  2047.      Alt-Z           Toggles the status display in the bottom line.  The
  2048.                      default is to display the cursor key usage.   Using
  2049.                      Alt-Z changes  the bottom  line to  show the option
  2050.                      switches "Toggles:" settings.
  2051.  
  2052.  
  2053.  
  2054.  
  2055. Page  29                                                    LIST  User's Guide
  2056. Configuring LIST
  2057. ______________________________________________________________________________
  2058.  
  2059. Screen Colors
  2060.  
  2061.  
  2062.     The screen's lines may be in one of three different colors:
  2063.  
  2064.                 o  the 'special' color for the top status line and the
  2065.                    bottom command line
  2066.                 o  the 'normal' color for the file's text windows
  2067.                 o  the 'bright' color for lines with Find/Scan text,
  2068.                    and for the upside-down question mark in 7-bit mode
  2069.  
  2070.     There is a pair  of function keys assigned  to each color.  You  use
  2071.     these  function  keys  at  any  time  to  change  the background and
  2072.     foreground colors temporarily, or  use the Alt-C cloning  command to
  2073.     make the colors permanent.  Alt-C requires that the LIST.COM program
  2074.     file be on the current drive and in the current directory unless you
  2075.     are using DOS version 3.3 or later.  With DOS 3.3, the program  file
  2076.     may have any name and may reside in any subdirectory.
  2077.  
  2078.     The border  is not  changed.  The  foreground color  applies to  the
  2079.     color of the characters.
  2080.  
  2081.     You may clone a  second set of text  colors for the second,  and any
  2082.     other windows that you may create.
  2083.  
  2084.     The color attributes may be changed by using these function keys:
  2085.  
  2086.           For the main body of text:
  2087.  
  2088.                 F5 - background color
  2089.                 F6 - foreground color
  2090.  
  2091.           For the top and bottom lines:
  2092.  
  2093.                 F7 - background color
  2094.                 F8 - foreground color
  2095.  
  2096.           For the line with Find/Scan text:
  2097.  
  2098.                 F2 - background color
  2099.                 F4 - foreground
  2100.  
  2101.     Once you have decided upon the colors, use the Alt-C key combination
  2102.     to  change  the  LIST.COM  program  file.  This process is described
  2103.     below.
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120. LIST  User's Guide                                                    Page  30
  2121. Configuring LIST
  2122. ______________________________________________________________________________
  2123.  
  2124. Cloning
  2125.  
  2126.  
  2127.     The screen colors, the display retrace testing (M), the file sharing
  2128.     (S), ruler (Alt-R), and other options may be permanently set in  the
  2129.     program COM file by using the Alt-C cloning function.
  2130.  
  2131.     For cloning to  take effect, the  program should be  called LIST.COM
  2132.     and on the current drive and in the current directory.
  2133.  
  2134.     There  are  THREE  versions  of  the  LIST program file.  One is the
  2135.     normal full program, which is LIST.COM.  The other, which is  called
  2136.     LISTS.COM, is a slightly smaller file that excludes the Help screen.
  2137.     The third is LIST PLUS, found as LISTP.COM.  You may use any of  the
  2138.     three  COM  files  for  cloning.   After  cloning,  you may continue
  2139.     viewing  the  file.   Several  of  the  command  toggles  are   also
  2140.     'clonable'.
  2141.  
  2142.     The values and toggles that are cloned are:
  2143.  
  2144.              M      =  Mono monitor, affects retrace testing. If you see
  2145.                        "snow" on your color monitor, turn off this option
  2146.  
  2147.              Alt-S  =  file(s) are shared
  2148.  
  2149.              W      =  Wrap long lines
  2150.  
  2151.              8/7/*  =  display all 256 values, or 7-bit, or special case
  2152.  
  2153.              K      =  flush Keyboard each time a command is read
  2154.  
  2155.              Alt-H  =  hex dump display, like the DEBUG format
  2156.  
  2157.              Alt-J  =  toggle "junk" filter, add LF to CR, fix backspaces
  2158.  
  2159.              Alt-L  =  set on to force preloading (reading) of the entire
  2160.                        file before any lines are displayed, Default is OFF.
  2161.  
  2162.              Alt-N  =  toggles screen saving (see Alt-X) feature
  2163.  
  2164.              Alt-R  =  toggle columnar ruler on top line
  2165.  
  2166.              Alt-T  =  toggle expansion of TAB characters
  2167.  
  2168.              Alt-V  =  number of filenames per line (up value) and sort method
  2169.  
  2170.              F2     =  change background color for Find/Scan text
  2171.              F4     =  change foreground color for Find/Scan text
  2172.  
  2173.              F5     =  change background color for main body of display
  2174.              F6     =  change foreground color for main body of display
  2175.  
  2176.              F7     =  change background color for top and bottom lines
  2177.              F8     =  change foreground color for top and bottom lines
  2178.  
  2179.     Note:  Be  sure  you  have  no  other  copies  of LIST.COM which are
  2180.     accessible (because  of a  filepath type  of utility).   If you  are
  2181.     familiar with the DOS utility DEBUG, you may want to modify LIST  in
  2182.     that way.  This is described in the next section.
  2183.  
  2184.  
  2185. Page  31                                                    LIST  User's Guide
  2186. Configuring LIST
  2187. ______________________________________________________________________________
  2188.  
  2189. Modifying LIST.COM
  2190.  
  2191.  
  2192.   Locations of option values
  2193.  
  2194.     This information is offered to those of you who wish to modify  LIST
  2195.     in special ways.  You do not need this information to use LIST.   An
  2196.     alternative to cloning  is to use  DEBUG to make  permanent changes.
  2197.     Here is a list of key items and their addresses:
  2198.  
  2199.            0132 - special lines 1 and 25 colors, default is 70 (reverse).
  2200.                   Refer to a technical reference guide for the
  2201.                   attribute values for the colors that you want.
  2202.  
  2203.            0134 - normal lines 2 thru 24 colors, default is 07 (white)
  2204.  
  2205.            0136 - bright color for Find/Scan, default is 0F (bright white)
  2206.  
  2207.            0138 - color used for text for first window, default is 07 (white)
  2208.            0139 - color used for second window, default is 0F (bright white)
  2209.  
  2210.            013A - clonable options;
  2211.                MRSJ WHK*  M = mono, retrace testing if off, x'01'
  2212.                           R = ruler, x'02'
  2213.                           S = shared, x'04'
  2214.                           J = add LF to lone CR, process backspaces,
  2215.                               if on, x'08'; default is off
  2216.                           W = wrap mode, x'10'
  2217.                           H = hi-bit on, x'20'
  2218.                           K = kybd flush, x'40'
  2219.                           * = special document filtering, x'80'
  2220.  
  2221.            013B - more clonable options, not all are indicated:
  2222.                .PAT DGV.  P = Preload file if on, x'02', default is off
  2223.                           A = Apxcore if on, TV/DD/DV if off, x'04,
  2224.                               default is for Topview/Double DOS use
  2225.                           T = if on (default), expand TABs, x'08'
  2226.                           D = hex display mode if on, x'10'
  2227.                           G = if on, Alt-G goto DOS is Disabled, x'20'
  2228.                           V = if on, screen save/restore is Disabled
  2229.                               and 9K less memory is used/required, x'40'
  2230.  
  2231.     By specifying the bit value, the option is enabled.  For example, to
  2232.     enable Shared and Retrace, specify a hex value of the sum, or  01+04
  2233.     = 05.
  2234.  
  2235.            013C - row less one at which found text is displayed,  1 byte
  2236.                   the default is 08 which displays found text on line  9
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250. LIST  User's Guide                                                    Page  32
  2251. Configuring LIST
  2252. ______________________________________________________________________________
  2253.  
  2254. Modifying LIST.COM
  2255.  
  2256.  
  2257.  
  2258.     When the  Find/Scan command  is used,  the next  line which contains
  2259.     that text is highlighted using the 'bright' color, and is placed  in
  2260.     row 9 of the screen.  You can change the row by Altering the byte at
  2261.     location 12F which is normally '08', one less than the row.
  2262.  
  2263.            013E - scroll offset value,  default is 10 (x'0A'),  one byte
  2264.  
  2265.            0140 - scroll starting value, default is 0 (x'00'), one byte
  2266.  
  2267.            0142 - tab increment, must be power of 2, default is 8
  2268.  
  2269.            0144 - tab mask, subtract tab incr from FFFFh,default is FFF8
  2270.  
  2271.            0146 - beep tone, default is 200 (hex C800)
  2272.  
  2273.            0148 - key rate, one byte, default is FF (255)
  2274.  
  2275.            0149 - page overlap, one word, default is 0000
  2276.  
  2277.            014B - search wildcard escape character, default is & (ampersand)
  2278.  
  2279.            014C - Alt-V filenames per line, one byte, default is 6 up
  2280.  
  2281.            0368 - WHAT eye-catcher
  2282.            036C - WHAT keys/function table (see below)
  2283.  
  2284.            0400 - WHERE eye-catcher
  2285.            0404 - WHERE routines table
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315. Page  33                                                    LIST  User's Guide
  2316. Configuring LIST
  2317. ______________________________________________________________________________
  2318.  
  2319. Modifying LIST.COM
  2320.  
  2321.  
  2322.   Reassigning keys
  2323.  
  2324.     LIST performs a function for every character that can be entered  at
  2325.     the command line prompt.  There  are 128 regular characters and  131
  2326.     extended characters.  The regular characters are numbered from 0  to
  2327.     127, and  they include  the letters  A-Z, a-z,  the numbers, and the
  2328.     rest of  the usual  single characters  found on  your keyboard.  The
  2329.     extended characters represent special function keys and combinations
  2330.     of keys, such as F1, Alt-X, Ctrl-A, and the cursor positioning keys.
  2331.  
  2332.     The  WHAT  table  in  LIST  has  a  one  byte  entry for each of the
  2333.     characters.  This byte is a number from 0 to 57 that represents  the
  2334.     identification of a routine that performs a function.
  2335.  
  2336.         For example,
  2337.  
  2338.           - the ESCape key has a value  of 27 (hex 1B) and its value  in
  2339.             the WHAT table is 16 (10 hex).  Routine number 16 is  called
  2340.             "Done".  The "Done" routine exits to DOS.
  2341.  
  2342.           - the Q key has a value of 81 (51 hex) with a routine value of
  2343.             15  for  the  "Close"  routine.   The  "Close"  routine ends
  2344.             viewing of the  current file and  tries to display  the next
  2345.             file, i.e. wildcards used for the filename.  There is also a
  2346.             lower case letter q, so be sure to change both entries.
  2347.  
  2348.  
  2349.     To change the function that a command character performs, you change
  2350.     the  value  in  the  WHAT  table  for the routine that the character
  2351.     invokes.
  2352.  
  2353.     For example, to  change the ESCape  key to act  like the Q  key, you
  2354.     change the routine  value for ESCape  from 16 (10  hex) to a  15 (0F
  2355.     hex).
  2356.  
  2357.     To find the location of the  routine value in the WHAT table,  first
  2358.     determine the value of the  character, e.g.  ESCape is 27  (1B hex),
  2359.     and then add that to the  location of the WHAT table (36C  hex); or,
  2360.     1B + 36C = 387 hex.  Finally,  use DEBUG to change the byte at  that
  2361.     location (387 hex) from a 10 hex to a 0F hex.
  2362.  
  2363.     For example,
  2364.  
  2365.           debug list.com                ; use appropriate file name
  2366.           -e 387 0f                     ; change ESC to routine 15
  2367.           -w                            ; old data is 10
  2368.           -q
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380. LIST  User's Guide                                                    Page  34
  2381. Configuring LIST
  2382. ______________________________________________________________________________
  2383.  
  2384.   Table of Routines
  2385.  
  2386.  
  2387.     Value Key(s)               Description of function performed
  2388.     ----- ---------            ------------------------------------------
  2389.       0                        Error, undefined command
  2390.  
  2391.       2   Alt-E                Toggle EGA 43-line mode
  2392.  
  2393.       3   Alt-F, G             Get new filespec
  2394.  
  2395.       4   Alt-J                Toggle Junk filter
  2396.  
  2397.       5   Alt-L                Toggle pre-Load
  2398.  
  2399.       6   Alt-T                Toggle TABs expansion
  2400.  
  2401.       7   Alt-W                Toggle Split windows
  2402.  
  2403.       8   Alt-X                Exit to DOS, restore screen
  2404.  
  2405.       9   U/up                 Position to previous line
  2406.  
  2407.      10   END, B               Position to end of file
  2408.  
  2409.      11   F5                   Change top/bottom line background color
  2410.  
  2411.      12   F6                   Change top/bottom line foreground color
  2412.  
  2413.      13   Ctrl-HOME            Position to specified line number
  2414.  
  2415.      14   Alt-C                Rewrite LIST.COM with new options
  2416.  
  2417.      15   Q, Ctrl-PgDn         Quit current file, display next file
  2418.  
  2419.      16   ESC, F10             Exit to DOS
  2420.  
  2421.      17   N, down              Position to next line
  2422.  
  2423.      18   X                    Exit to DOS, clear screen
  2424.  
  2425.      19   Alt-H                Toggle Hex display mode
  2426.  
  2427.      20   8                    Leave hi-bit
  2428.  
  2429.      21   \, F                 Search for text, any case matches
  2430.  
  2431.      22   F2                   Change Find/Scan background color
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445. Page  35                                                    LIST  User's Guide
  2446. Configuring LIST
  2447. ______________________________________________________________________________
  2448.  
  2449.   Table of Routines
  2450.  
  2451.     Value Key(s)              Description of function performed
  2452.     ----- ---------           ------------------------------------------
  2453.      23   F4                  Change Find/Scan foreground color
  2454.  
  2455.      24   Alt-M               Toggle monitor rescan testing
  2456.  
  2457.      25   K, Alt-K            Toggle keyboard flush (type ahead)
  2458.  
  2459.      26   Alt-G               Invoke DOS command (shell)
  2460.  
  2461.      27   L, left             Scroll left 10 columns
  2462.  
  2463.      28   -                   Position back by number of lines
  2464.  
  2465.      29   enter               Display next page
  2466.  
  2467.      30   +                   Position forward by number of lines
  2468.  
  2469.      31   P                   Print current screen or marked lines
  2470.  
  2471.      32   F1 H ?              Display Help screen
  2472.  
  2473.      33   F3, A               Search for next occurrence of text
  2474.  
  2475.      34   R right             Scroll display right 10 columns
  2476.  
  2477.      35   Alt-R               Display ruler marks on top line
  2478.  
  2479.      36   /, S                Search for text, same case
  2480.  
  2481.      37   F9                  Search for previous occurrence of text
  2482.  
  2483.      38   Ctrl-left           Reset scroll to column 1, full left
  2484.  
  2485.      39   F7                  Change normal line background color
  2486.  
  2487.      40   F8                  Change normal line foreground color
  2488.  
  2489.      41   7                   Strip hi-bit
  2490.  
  2491.      42   Alt-S               Toggle closing of files
  2492.  
  2493.      43   *                   Toggle special * filter
  2494.  
  2495.      44   Home, T             Position to top of file
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510. LIST  User's Guide                                                    Page  36
  2511. Configuring LIST
  2512. ______________________________________________________________________________
  2513.  
  2514.   Table of Routines
  2515.  
  2516.     Value Key(s)              Description of function performed
  2517.     ----- ---------           ------------------------------------------
  2518.  
  2519.      45   B, up               Position back one line
  2520.  
  2521.      46   W                   Toggle display of wide lines
  2522.  
  2523.      47   Alt-D               Write marked lines to a file
  2524.  
  2525.      48   Alt-M               Mark top line of display
  2526.  
  2527.      49   Alt-U               Unmark lines
  2528.  
  2529.      50   Alt-B               Mark bottom line of display
  2530.  
  2531.      51   Ctrl-pgup           Display previous file
  2532.  
  2533.      52   ^                   Like Find but initiates search backwards
  2534.  
  2535.      53   v                   Like Scan but initiates search backwards
  2536.  
  2537.      54   Alt-N               Toggle screen saving (Alt-X) function
  2538.  
  2539.      55   C                   Toggle continuous scrolling
  2540.  
  2541.      56   Alt-Y               Bookmark, reposition to last "active" line
  2542.  
  2543.      57   Alt-O               Write marked lines to previous Alt-D file
  2544.  
  2545.      58   Ctrl-F              Sends a formfeed control character to printer
  2546.  
  2547.      59   Alt-A               Continues text search across files
  2548.  
  2549.      60   Ctrl-P              Print the entire file
  2550.  
  2551.      61   Alt-I               Grab a filespec from the display
  2552.  
  2553.      62   Alt-V               File selection menu
  2554.  
  2555.      63   ESCape              Exit from Alt-V file menu
  2556.  
  2557.      64   Alt-Z               Toggle line 25 status display format
  2558.  
  2559.      65   Ctrl-V              Switch display window
  2560.  
  2561.      66   Ctrl-T              Grab a telephone number and dial the modem
  2562.  
  2563.      67   Ctrl-H              Disconnect modem (hang up)
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575. Page  37                                                    LIST  User's Guide
  2576. Limitations
  2577. ______________________________________________________________________________
  2578.  
  2579.  
  2580.  
  2581.      o  The LIST.COM  program requires about  64K  of memory.   If  more
  2582.         memory is available,  it is used  to store more  of the file  in
  2583.         memory.  At least 80K is required  to use the DOS shell, and  9K
  2584.         more is required if the screen saving option (on by default)  is
  2585.         enabled.
  2586.  
  2587.  
  2588.      o  The line number is currently limited to 16 million.
  2589.  
  2590.  
  2591.      o  The file size is limited to 16 million bytes for ASCII  files,
  2592.         and 4 million bytes for hex-dump files.
  2593.  
  2594.  
  2595.      o  The review limit is 32 files.
  2596.  
  2597.  
  2598.      o  PC DOS Version 2.0 or  later is required.  DOS version 3.0  or
  2599.         later is required for file sharing.
  2600.  
  2601.  
  2602.      o  ANSI.SYS is NOT required.
  2603.  
  2604.  
  2605.  
  2606.         APX Core, DesqView, TopView, Double  DOS, PCED, and IBM are  all
  2607.         copyrighted, trademarked, and all that.
  2608.  
  2609.  
  2610.  
  2611.     If you are using LIST and find it of value, your gift in any  amount
  2612.     ($20 suggested)  will be  greatly appreciated.   Please make  checks
  2613.     payable in U.S. dollars to  Vernon D. Buerg.  Canadian and  non-U.S.
  2614.     checks are not acceptable.
  2615.  
  2616.     For use by  corporations and other  institutions, please contact  me
  2617.     for a licensing  arrangement.  More information  is supplied in  the
  2618.     file  LICENSE.   Customizing,  licensing  of  the  source, and other
  2619.     special licensing are available  upon request.  Purchase orders  and
  2620.     invoicing are acceptable.
  2621.  
  2622.  
  2623.                       Vernon D. Buerg
  2624.                       139 White Oak Circle
  2625.                       Petaluma, CA  94952
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640. LIST  User's Guide                                                    Page  38
  2641. Copyright/License/Warranty
  2642. ______________________________________________________________________________
  2643.  
  2644.  
  2645.     This  document  and  the  program  files  LIST.COM,  LISTS.COM,  and
  2646.     LISTP.COM  ("the  software")  are  copyrighted  by  the author.  The
  2647.     copyright owner hereby licenses you to use the software given  these
  2648.     restrictions:
  2649.  
  2650.           o  the program shall  be supplied in its  original, unmodified
  2651.              form, which includes this documentation;
  2652.  
  2653.  
  2654.           o  for-profit use without a license is prohibited;
  2655.  
  2656.           o  the program may not be  included - or bundled - with  other
  2657.              goods or services.  Exceptions may be granted upon  written
  2658.              request only.
  2659.  
  2660.           o  no  fee  is  charged;  an  exception is  granted to not for
  2661.              profit user's groups, which are permitted to charge a small
  2662.              fee (not  to exceed  $5) for  materials, handling, postage,
  2663.              and general overhead.   No other organization  is permitted
  2664.              to  charge  any  amount  for  distribution of copies of the
  2665.              software  or  documentation,  or  to  include copies of the
  2666.              software or documentation with sales of their own products.
  2667.  
  2668.     There is no warranty  of any kind.  The  copyright owner may not  be
  2669.     held liable  for any  damages, including  any lost  profits or other
  2670.     incidental or consequential damages  arising out of or  inability to
  2671.     use the software.  By using the software, you agree to this.
  2672.  
  2673.     The software and documentation are:
  2674.  
  2675.                 Copyright (C) 1983-1989 by
  2676.                    Vernon D. Buerg
  2677.                    139 White Oak Circle
  2678.                    Petaluma, CA  94952
  2679.  
  2680.                 Data:   (707) 778-8944    VOR 24-hour bulletin board
  2681.                 - or -  (707) 778-8841    MB  24-hour bulletin board
  2682.                 Compuserve: 70007,1212
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705. Page  39                                                    LIST  User's Guide
  2706. LIST  User's Guide                                                 Index-1
  2707. __________________________________________________________________________
  2708.  
  2709.   /*,command line,star filter .. 5, 31
  2710.   /7,command line,7-bit option . 5, 31
  2711.   /8,command line,8-bit option . 5
  2712.   /H,command line,hex option ... 5
  2713.   /J,command line,junk filter .. 5
  2714.   /L,command line,preload option 5
  2715.   /S,command line,piping option  5, 6
  2716.   /W,command line,wrap option .. 5
  2717.   1-6 up,directory display ..... 22, 24
  2718.   Alt-A,find text again ........ 15, 16, 29, 37
  2719.   Alt-B,mark bottom line ....... 12, 17, 29, 37
  2720.   Alt-C,clone new LIST.COM ..... 20, 29, 30, 31, 35
  2721.   Alt-D,Write marked lines ..... 17, 29, 37
  2722.   Alt-E,toggle 25/43 lines ..... 8, 29, 35
  2723.   Alt-F,enter new filename ..... 19, 26, 29, 35
  2724.   Alt-G,go to DOS .............. 2, 21, 29, 32, 36
  2725.   Alt-H,toggle hex display ..... 13, 14, 29, 31, 35
  2726.   Alt-I,insert filename ........ 2, 19, 24, 29, 37
  2727.   Alt-J,toggle junk filter ..... 14, 17, 29, 31, 35
  2728.   Alt-K,toggle key ahead ....... 7, 36
  2729.   Alt-L,toggle file preloading . 12, 29, 31, 35
  2730.   Alt-M,mark top line .......... 12, 17, 29, 36, 37
  2731.   Alt-N,toggle screen saving ... 29, 31, 37
  2732.   Alt-O,write marked lines ..... 17, 29, 37
  2733.   Alt-P,print marked lines ..... 17, 18
  2734.   Alt-R,toggle ruler display ... 8, 29, 31, 36
  2735.   Alt-S,toggle file sharing .... 15, 21, 29, 31, 36
  2736.   Alt-T,toggle TAB expansion ... 14, 29, 31, 35
  2737.   Alt-U,unmark lines ........... 17, 29, 37
  2738.   Alt-V,Change Directories ..... 2, 19, 23, 29, 31, 33, 37
  2739.   Alt-W,freeze top window ...... 2, 14, 20, 23, 29, 35
  2740.   Alt-X,exit to DOS ............ 2, 7, 17, 19, 21, 29, 31, 34, 35, 37
  2741.   Alt-Y,reposition to last line  12, 29, 37
  2742.   Alt-Z,Toggle status line ..... 9, 29, 37
  2743.   archive,files ................ 24
  2744.   bulletin board,support ....... 39
  2745.   Changing Directories ......... 23
  2746.   Cloning ...................... 11, 21, 30, 31, 32
  2747.   Colors ....................... 6, 20, 30, 31, 32
  2748.   Command line syntax .......... 5
  2749.   Command line,option switches . 4, 5, 8, 9, 10, 19, 22, 30, 34
  2750.   Configuring LIST ............. 11, 21
  2751.   Continuous,scrolling ......... 10, 11, 26, 37
  2752.   Copy file .................... 23
  2753.   Ctrl-A,Full left scroll ...... 28, 34
  2754.   Ctrl-C,Next page ............. 28
  2755.   Ctrl-D,Scroll right .......... 28
  2756.   Ctrl-E,Previous line ......... 28
  2757.   Ctrl-F,Send printer formfeed . 18, 28, 37
  2758.   Ctrl-HOME,Position to a line . 12, 22, 28, 35
  2759.   Ctrl-H,Hang up phone ......... 20, 28, 37
  2760.   Ctrl-left,Position to column 1 28, 36
  2761.   Ctrl-N,Next file ............. 28
  2762.   Ctrl-PgDn,Show next file ..... 19, 28, 35
  2763.   Ctrl-PgUp,Show previous file . 19, 28, 37
  2764.  
  2765. Index-2                                                LIST  User's Guide
  2766. __________________________________________________________________________
  2767.  
  2768.   Ctrl-P,Print entire file ..... 18, 28, 37
  2769.   Ctrl-R,Previous page ......... 28
  2770.   Ctrl-S,Scroll left ........... 28
  2771.   Ctrl-T,Dial telephone ........ 2, 20, 28, 37
  2772.   Ctrl-U,Previous file ......... 28
  2773.   Ctrl-V,Switch windows ........ 20, 28, 37
  2774.   Ctrl-W,Previous line ......... 28
  2775.   Ctrl-X,Next line ............. 28
  2776.   DEBUG,changing options ....... 14, 21, 31, 32, 34
  2777.   Delete file .................. 23
  2778.   DOS Filters .................. 3
  2779.   DOS Pipes .................... 4
  2780.   DOS Redirection .............. 3
  2781.   Entering Commands ............ 7
  2782.   Exit to DOS .................. 25, 26, 35
  2783.   F- function keys ............. 25
  2784.   F10,Exit to DOS .............. 7, 19, 25, 35
  2785.   F1,Display Help .............. 22, 25, 34, 36
  2786.   F2,Find background color ..... 25, 30, 31, 35
  2787.   F3,Find next ................. 15, 16, 25, 36
  2788.   F4,Find foreground color ..... 25, 30, 31, 36
  2789.   F5,Text background color ..... 25, 30, 31, 35
  2790.   F6,Text foreground color ..... 25, 30, 31, 35
  2791.   F7,Status background color ... 25, 30, 31, 36
  2792.   F8,Status foreground color ... 25, 30, 31, 33, 36
  2793.   F9,Find previous ............. 15, 16, 25, 36
  2794.   File Sharing ................. 21, 29, 31, 38
  2795.   Filtering .................... 1, 4, 6, 13, 14, 32
  2796.   Find,text .................... 4, 9, 12, 15, 16, 23, 24, 25, 26, 27, 30
  2797.                                  31, 32, 33, 34, 35, 36, 37, 38
  2798.   Hex dump,display mode ........ 5, 10, 13, 14, 31
  2799.   Hi-bit,filter usage .......... 14, 32, 35, 36
  2800.   Installation ................. 1
  2801.   Invoking DOS Commands ........ 21
  2802.   Junk,filter usage ............ 5, 13, 14, 17, 29, 31, 35
  2803.   License,information .......... 38, 39
  2804.   List file .................... 23
  2805.   Locations of option values ... 32
  2806.   Move file .................... 23
  2807.   Movement Keys ................ 22
  2808.   Path changing ................ 23
  2809.   Piped,files .................. 5, 6
  2810.   Piping ....................... 1, 4, 6
  2811.   Printing the manual .......... 1
  2812.   Print,files or lines ......... 1, 6, 10, 17, 18, 28, 36, 37
  2813.   Reassigning keys ............. 34
  2814.   Redirection .................. 1, 3, 4, 6
  2815.   Rename ....................... 24
  2816.   Scan,for text ................ 5, 9, 12, 15, 16, 25, 26, 27, 30, 31, 32
  2817.                                  33, 35, 36, 37
  2818.   Screen saving,option ......... 2, 7, 21, 29, 31, 37, 38
  2819.   Scrolling .................... 11, 26, 37
  2820.   Shell,to DOS ................. 36, 38
  2821.   Sort filenames ............... 24
  2822.   Star,filter usage ............ 5, 13, 14, 22
  2823.   Status Line Format ........... 8
  2824.   Switches,command line ........ 5, 29
  2825.   TAB,control character ........ 10, 13, 14, 29, 31, 33
  2826.   Telephone dialer ............. 20
  2827.   ViewArc ...................... 24
  2828.   Wrap,filter .................. 5, 10, 12, 13, 14, 26, 31, 32
  2829.  
  2830.